CREG 13* 

GREG 14* 

CREG 15*t 
CREG 16*t 
CREG 17-19 
CREG 20-63 


Defines start corner for PIXMOV: desti¬ 
nation window. 

Controis direction of pixei writing for 
PiXMOV destination window. 

Screen origin of overiay piane 0. 
Screen origin of overiay plane 1. 
Reserved for future definition. 
Unassigned. Available for temporary 
coordinate storage. 
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Default Port Configurations 

Port Mnemonic RTS CTS Baud 

Parity 

XIN 

XOUT 

CTRL 

STOP 

NBITS 

MODEMSIO 

Off 

off 

1200 

none 

on 

off 

off 

1 

8 

KEYBSIO 

off 

off 

300 

none 

on 

off 

on 

1 

8 

TABLETSIO 

off 

off 

1200 

none 

on 

off 

off 

2 

8 

GRINSIO 

off 

off 

1200 

none 

off 

off 

off 

2 

8 

HOSTSIO 

off 

off 

9600 

none 

off 

on 

off 

2 

8 

ALPHASIO 

off 

off 

9600 

none 

on 

off 

on 

2 

8 


Alphanumeric Terminal Emulation** 

ALPHEM**flag Enables (flag = 1 or ON) or disables 

(flag=0 or OFF) the alphanumeric terminal 


Value Register Assignments 

VREG 0 Current Value The value used in al! graphics primi¬ 
tives commands. 


VREG 1 
VREG 2 
VREG 3 
VREG4*t 
VREG 5*t 
VREG 6 
VREG 7-15 
VREG 16, 19...40** 

VREG 17, 20,.,41** 

VREG 18, 21...42** 
VREG 43-50 
VREG 51-63 


Value used for crosshair 0. 

Value used for crosshair 1. 

Fill Mask used for Area fills. 

Color assignment for overlay plane 0. 
Color assignment for overlay plane 1. 
For future definition. 

Available for temporary value storage. 
Foreground color, alphanumeric windows 
0 - 8 . 

Background color, alphanumeric windows 
0 - 8 . 

Cursor color, alphanumeric windows 0-8. 
For future definition. 

Available for temporary value storage. 
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BOLD** flag 

DEFWIN** window, x1, 
y1, x2, y2, x-size, y-size, 
bitm, bankm 


DELWIN** window 
DIRCUR**x,y 

GETCUR** 

GETPOS** 

GETWIN** 

HOME** 


System Configuration Commands • • 


DFTCFG 

Restore all ports to default configurations. 

DISCFG 

Display current system configurations. 

SAVCFG 

Save configuration set with SYSCFG, 1 

SYSCFG HOST 

Mode [ASCII/BINARY] 

SYSCFG IEEE 

(address) [NORMAL) [TALK) [LISTEN] 

SYSCFG SERIAL 

(Port-mnemonio) [RTS on/off] [CTS on/ot(] 


[STOP 1/2] [BITS 7/8] [PARITYe/o/1 /h/n] 


[BAUD rate] [XIN on/off] [XOUTon/off] 


[CTRL on/off] 

SYSCFG SERIAL 

TABLET [GTCO/SUMMA]. 


Move UR** x,y 
OVRSTK** flag 
SCROLL** flag 
SELWIN** window 
SETCUR**flag 
SETSIZ** xscale,yscale 
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WRAP** flag 


emulator. Routes text to selected window. 
|C2 h) . 

Enables (flag = 1 or ON)or disables 
(flag=0 or OFF) drawing to bold text. [CChI 
Defines size and positions of indicated 
window number. (x1,y1) defines first corner; 
(x2,y2) defines diagonal corner, x-size, 
y-size define text size; bitm, bankm define 
write mask for window (see WRMASK com¬ 
mand). [CO|^] 

Deletes window. [C3|^] 

Moves cursor to character position x,y 
within window. [04^1 

Returns Model One coordinates of cursor 
in ourrentlyselected window. [C9 h 1 
Returns character position of cursor in 
currently-selected window. [C5nl 
Returns number of active window (—1 for no 
active window). [CEh 1 
Moves cursor to character position (0,0), 
the upper-left corner of the window. |CFnl 
Moves cursor to Model One coordinate x,y 
within window limits. |C8nl 
Enables (flag = 1 or ON) or disables 
(flag=0 or OFF) overstriking of text. [CDhI 
Enables (flag = 1 orON)ordisables 
(flag=0 or OFF) scrolling of text. 

Select window as defined by DEFWIN. Sets 
routing for ALPHEM command, |C1 ^1 
Enables (flag = 1 or ON) or disables 
(flag=0 or OFF) cursor. [07^1 
Sets x,y scaling (multiples of 16 pixels). 
Default is (1,1 ).[C6 h 1 
Enables (flag = 1 or ON) or disables 
(flag=0 or OFF) wraparound of text. [08^1 


Display List Firmwarett 

DEFVW view, wcsregl, 
wcsreg2, dcsregl, 
dcsreg2, upregl, upreg2, 
rotate, xform, backvreg. 
bitm, bankm, hiseg 


DELPID 

HILITE view, flag, vreg 


PICKCR view, desreg, 
searchflag 


RDPID 

RDREG 

RDTREE 

REDRAW view, flag 


SEGAPP segment 


SEGCOP segment2, 
segmenti 
SEGDEF segment 
SEGDEL segment 
SEGEND 

SEGINI words 
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SEGINQ segments 


SEGPID pickid 


Defines the view into the World Coordinate 
System, view gives the view number; 
wcsregl and wcsreg2 define the WCS 
corners; dcsregl and dosreg2 define the 
display viewport; upregl and upreg2 give 
the ends of the UP vector; rotate defines 
the WCS window rotation center; xform 
specifies fhe transformafion type; backvreg 
gives the ackground color; for bitm and 
bankm, see the WRMASK command; hiseg 
specifies the segment nesting. [EBj^] 

Delete primitives with PIDREG and 
SEGREG. [EC^] 

Highlight view in the color specified by 
vreg. flag = 1 or ON highlights primitives; 
flag = 0 or OFF draws primitives normally. 
PIDREG and SEGREG (see SET) are used. 

[dFhI 

Perform pick search; view is picked, using 
the desreg coordinates, searchflag = 1 or 
ON, search from current tree location; 
searchflag = 0 or OFF, search from the top 
of the segment. (E3|^] 

Reads and returns the graphics primitives 
with PIDREG and SEGREG (see SET). 

[EDhJ 

Reads and returns the current SEGREG 
and PIDREG (see SET and PICKCR). [EO^] 
Returns the PICKCR hierarchical history. 

[eEhI 

Redisplay view; flag = 1 or ON clears the 
window to the background color before 
display, view = -1 redisplays all views. 

[E2h] 

Open segment to append graphics 
primitive commands. SEGEND ends the 
append. [DB^] 

Copies segmenti into segments. [EA|_|] 

Begins definition of segment. [DC|_|] 

Deletes segment. [DE|_|] 

End segment definition begun with SEGDEF 
or SEGAPP. [DD^J. 

Initializes Display List Firmware; words 
gives the number of data words per seg¬ 
ment block. [E1|_|] 

Returns the attributes of segment. See 
SETATR). [ES^] 


SEGREF segment 

SEGREN segments, 
segmenti 
SET global.vaiue 


Defines the pickid for primitives within seg¬ 
ment until next SEGPID or SEGEND com¬ 
mand. [D9|^] 

Nest specified segment within current seg¬ 
ment. [D8|^] 

Renames segmenti to segments. [DA^] 


Set PICKAP aperture; set PIDREG value; 
set SEGREG value. [46^] 

Sets Visibility or PICKability of segment, 
flag = 1 or ON enables attribute (VIS or 
PICK); flag = 0 or OFF disables attribute. 
[E6 h] 

Returns system memory usage and 
availability. [E4|_|] 

ttOptional Firmware for Model One/25, Model One/40, and Model One/60, 


SETATR segment,attribute, 
flag 


SYSTAT 
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Raster 

MODEL ONE 

Programming Reference Card 

The following summary of the graphics commands supported by 
the standard firmware in the Model One product family. Brackets) ] 
indicate the hexadecimal opcode of each command. 

HELP List all command mnemonics. 

HELP mnemonic Give command information. 


Graphics Primitives 

ARC rad, a1, a2 

AREA1 


AREA2 vreg 

CIRCI creg 

CIRCLE rad 
CIRCXY X, y 

CLEAR 

DRW2R dx, dy 
DRW3R dx, dy 
DRWABS X, y 

DRWI creg 

DRWRELdx, dy 
FILMSK rmsk, gmsk, 
bmsk 

FLOOD 

■ MOV2Rdx, dy 

MOV3Rdx, dy 

MOVABSx, y 
f 

MOVI creg 

MOVRELdx, dy 
POINT 


Draw arc of radius rad. Starting angle 
is al; ending angle is a2. [11|_|] 

Area fill. Boundary is any pixel different 
in value from the current point. The 
area is filled with current value. [13^] 
Area fill. Boundary pixel value given in 
vreg. [14^1 

Draw circle. Location given by creg lies 
on the circumference. [10|_,] 

Draw a circle of radius rad. [OEhI 
Draw circle. Poinf x, y lies on the cir¬ 
cumference. [OFhI 

Flood current window to current pixel 
value. [87^1 

Draw vector relative by dx, dy. [84|_|] 
Draw vector relative by dx, dy. [83^] 
Draw vector from current point to the 
point X, y. [81^1 

Draw vector to location given by creg. 

[85h] 

Draw vector relative by dx, dy, [82^] 
Image data is ANDed with mask before 
checking value in AREA fill commands. 

I9Fh1 

Flood displayed image memory to cur¬ 
rent pixel value. [07^] 

Move relative by dx, dy, [04,_|] 

Move relative by dx, dy. [03^] 

Move absolute location of current point 
to X, y. [OIhI 

Move to location given by coordinate 
register creg. [05^] 

Move relative by dx, dy. [02^1 

Set current point to current pixel value. 

[88h] 


p 'j.qj 




























POLYGN npoly, verts 

Draw polygons. Npoly gives number of 

RUNLEN nrows, ncols. 


polygons; for each polygon, verts gives 
number of vertices and the vertices. 

r, g, b, cnt 


n2H] 

RUNLN8 nrows, ncols. 

PRMFILflag 

Primitive till. Filled primitives are drawn 
if tlag=1. If flag=0, the perimeter of gra¬ 

val, cnt 


phics primitives is drawn. [IF^j 

Display Control 

RECRELdx, dy 

Draw rectangle. Diagonal corner is dx, 
dy away from current point. [8E|_|] 

ASCII flag 

RECTAN X, y 

Draw rectangle. Point x, y specifies 


diagonal corner [89|_|] 

BLANK flag 

RECTI creg 

Draw rectangle. Location given by creg 



is diagonal corner. [SF^j 

COLD 

TEXT1 string 

Draw text string with font 1. [90„] 

CORORG X, y 

TEXT2 string 

Draw text string with font 2. [91 „] 


TEXTC size, ang 

Specify size of text and draw at angle 
ang.[92^] 

FIRSTPflag 

TEXTDN char, vecist 

Define downloaded character in font 2. 

[26h1 

MODDISflag 

TEXTRE 

Restore default character set. [Bl^] 


VALIKval 

Set current pixel value (for IK mode). 

[BOhI 

MODE1K funct 

VAL8 val 

Set current pixel value to val, val, val. 

[86h) 

OVRRD't plane, flag 

VALUE r, g, b 

Set current pixel value to r, g, b. [OS,,] 


VTEXT1 string 

Vertical text string with foht 1. [93^] 

OVRVAL't plane, flag 

VTEXT2 string 

Vertical text string with font 2. [94|_|j 


Look-Up Table Commands 


OVRZM't plane, flag 

LUTS index, r, g, b 

Make entry r, g, b at location given by 
index in Red, Green, and Blue LUTs. 



uchI 

PIXCLPflag 

LUTA index, entry 

Make entry in all LUTs. Place entry at 



location given in index. [IB^] 

PIXFUN mode 

LUTB index, entry 

Make entry in Blue LUT. Place entry at 



location given in index. [1A|^J 

PIXMOV 

LUTG index, entry 

Make entry in Green LUT. Place entry 
at location given in index. [19^1 


LUTR index, entry 

Make entry in Red LUT. Place entry at 

PMCTL* 0 0 0 0 


location given in index. [18|_|] 

redrte, greenrte, bluerte 

LUTRMP code, sind. 

Load LUTs with ramp function [1D|_|] 


eind, sent, ent 


QUIT 

LUTRTEt func 

Change LUT routing function specified 
by func. [18^1 

RDMASK mask 
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Image Transmissions 


SCRORG X, y 

PIXELS nrows, ncols, val 

Pixel by pixel image definition. Pixel 

SPCHARchar, flag. 


values are val. val, val. [29^] 

code 

PIXELS nrows, ncols, 

Pixel by pixel image definition. Pixel 


r, g. b 

values are r, g, b. [28^] 

TEKEM flag 


Run-length encoded stream. Pixel 
value is r, g, b. Horizontal count is cnt. 
[2 Ah] 

Run-length stream. Pixel value is val, 
val, val. Horizontal count is cnt. [28^] 


Sets host port Input as free format 
ASCII if flag^l, if flag=0 binary. 

(9Bh1 

Blanks screen when flag=1, normal 
video is restored when flag=0. (31^1 
Coldstart. Reset the Model One. [FD^] 
Loads coordinate origin register with 

X, y. [37 h1 

First pixel on vectors is inhibited when 
flag=1. uninhibited when flag=0. [2 Fh] 
Select display mode. 512 mode is 
selected if flag=0, IK mode is selected 
if flag-1. [2 Ch] 

Select output data routing in IK mode. 
[2 Dh] 

Display specified overlay plane when 
flag=0, inhibit display when flag= 1. 
[BAh] 

Set bits to 1 in specified overlay plane 
when flag=1, reset bits to 0 when 
flag-0. [B9 h] 

Display plane at scale factor 1:1 if 
flag=0, display at same scale fact as 
image memory if flag=1. [88^1 
Pixel processor clipping status. Clip on 
over/underflow flag=1. [3 Ch] 

Set pixel processor mode. All vectors 
and DPMA writes are affected. [38^1 
Initiate pixel mover transfer. Move win¬ 
dow specified by CREG 11 and 12 as 
controlled by CREG 13 and 14. [88^] 
Set pixel mover mode; redrte, greenrte, 
and bluerte control writing into the red, 
green, and blue banks. [BF^] 

Exit graphics mode. (FF^] 

Set Read Mask. All pixel values read 
from image are ANDed with mask. 
[9 Eh] 

Set screen origin register to x,y [36^] 
Redefine speciai characters (see 
Speciai Characters beiow). if fiag=0, 
disable, flag=1, enable. [B2|^] 

Invoke Tektronix emulator. [39^] 


VECPAT mask 
VGWAIT frames 
WAIT frames 

WARM 

WINDOW x1, y1, x2, y2 
WRMASK bitm, bankm 

XHAIR num, flag 

ZOOM fact 
ZOOMIN 


Vector generator pattern register is set 
to mask. 12E^] 

Inhibit transfer of vectors from vector 
queue for frames frame times. [30,,] 
Wait for given number of frame times 
before continuing command execution. 
[3 Dh] 

Warmstart. Reinitialize Model One. 


READCR creg 
READER 
READF func 
READP 


|FE„1 

Set current window. Defined by diago¬ 
nal xl.yl and x2,y2. [SA^] 

Set Write-Enable Mask. Bit planes indi¬ 
cated by bitm and banks indicated by 
bankm are write-enabled. [98^] 
Enable/Disable Crosshair number num. 
If flag-1 enable, if flag=0 disable. 

[9CHj 

Zoom by factor of fact=1, 2, 4 or 8. 

|34h1 

Zoom in by factor of 2. [35Hj 


READVR vreg 

READW nrows, ncols, bf 

READWE nrows, ncols, 
bf 

Register Operations 

CADD csum, creg 
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CLOAD creg x, y 


Special Characters (Default Values) 


ASCII Code Char 

CTL D 0 

CTL P 1 

ESC or CTL[ 2 
@ 3 

CTL H 4 

CTL F 5 

CTL U 6 

I CTL X 7 

CTLS 8 

CTLQ 9 


Purpose 

ENTER GRAPHICS 

Break 

Warmstart 

Line Kill 

Backspace 

ACK 

NACK 

Invoke Debug 
Suspend Communications 
Resume Communications 


CMOVE cdst, csrc 
CSUB edit, creg 
VADD vsum, vreg 

VLOAD vreg, r, g, b 

VMOVE vdst, csrc 
VSUB vdif, vreg 

Software Development 

ALPHAO strlen, string 


FORTRAN Utility Subroutines 


Call EMPTYB 
Call ENTGRA 
Call SEND1 (val) 
Call SEND2 (val) 


Empty Buffers 

Enter Graphics Mode 

Send one bvte to output buffer. 

Send 2 bytes (16 bits) to output buffer. 


Readback Commmands 

All Read commands require a 7-bit ASCII ACK. 

RDMODE flag Set readback mode to ASCII decimal 

(flag = OFF or 0) or binary (flag = ON 
orl). [D3 h] 

READBU fig, efig Read button number. If flag=1 wait for 

next button. If flag=0 send number of 
last button pushed. If cflg=1 send cur¬ 
rent digitizing tablet coordinate, if 
clfg=0 send current joystick/trackball 
coordinate. [9A„] 


DEBUG flag 

DELAY factor 
DNLOAD 

HOSTO strlen, string 

NULL 

PEEKaddr 

POKE addr, data 

REPLAY 


Read coordinate register. Send x,y to Macro Programming 

port in graphics mode. [98 h 1 MACDEF num 

Return byte with number of first error. 

[38h] 


Define Macro number num. Macro is 
terminated by MACEND command. 
[SBhI 


Sets pixel readback format. Func speci¬ 
fies format. [27„] 

Read Pixel. Send value of pixel to port 
in graphics mode. [95„] 

Read value register. Send pixel value to 
port in graphics mode. [99„] 

Read Window. Send value of pixels in 
window to port in graphics mode. [96„] 
Read Window run-length encoded. 

Send values of pixels in window in run- 
length encloded form to port in gra¬ 
phics mode. [97|_|] 


Place result of csum+creg in csum. 
tA2H] 

Load coordinate register creg with x,y. 
(AOh) 

Move contents of csrc into cdst. [AIhI 
Place result of cdif-creg in edif. (ASh) 
Place result of vsum+ vreg into vsum. 
[A6 h] 

Load contents of value register vreg 
with r, g, b. [A4|_|] 

Move contents of vsrc into vdst. (ASh) 
Place result of vdif-vreg into vdif. [A7„j 


Program comment [80|_|] 

Send text string to local alpha-numeric 
display. [B4|_|] 

Enter/Exit Command Stream Translator. 
Exit when flag=0, else enter. [A8 h 1 
Delay transmission of characters. [B6 h] 
Download Z8002 object code. String 
format is Tektronix Hex. [FB|_|] 

Send a text string to the host. [85^] 

No operation. [00|_|] 

Display contents of CPU memory. 
[BDhI 

Change contents of addr in CPU 
memory. [BE|_|] 

Dump last 32 characters of HOSTSIO 
input buffer to ALPHASIO port. [BC„1 


MACEND 

End of Macro definition. [OCh] 

MACERA num 

Erase Macro num. [80^] 

MACRO num 

Execute Macro num. [06^1 

Interactive Device Support 

BLINKC 

Clear blink table. [23^] 

BLINKD lut, index 

Disable Blink of specified lut, index. 
[21 h1 

BLINKElut, index 

Enable Blink specified lut, index. Use 

entryl, entry2 

entry 1 and entry 2 as alternate values. 
[20 h1 

BLINKR frames 

Blink rate is frame times. [22,_(] 

BUTTBL index, nmac 

Place Macro nmac in Button Table at 
location index. [AA^] 

BUTTON index 

Execute Macro indicated by Button 
Table at location index. [AB^^] 

FLUSH 

Empty function button event queue. 
I15 h] 

RDPIXR vreg 

Places value of pixel at current point in 
specified value register vreg. [AFhI 

Coordinate Register Assignment 

CREG 0 

Current Point. Starting point of gra¬ 
phics primitives. Updated by a MOVE 
or DRAW command. 

CREG 1 

Joystick/Trackball Cursor Location. 
Current coordinate from the joystick or 
trackball. Updated automatically. 

CREG 2 

Digitizing Tablet Cursor Location. Cur¬ 
rent coordinate from the digitizihg 
tablet. Updated automatically. 

CREG 3 

Coordinate Origin. Coordinate of the 
center of image memory. 

CREG 4 

Screen Origin. Coordinate of the pixel 
in the center of the screen. 

CREG 5 

Crosshair 0 Location in Image Memory. 

CREG 6 

Crosshair 1 Location in Image Memory. 

CREG 7*t 

Crosshair 2 Location in Image Memory. 

CREG 8*t 

Crosshairs Location in Image Memory. 

CREG 9 

Clipping Window Origin. Lower left 
corner of current clipping window. All 
vectors are clipped to this window. 

CREG 10 

Clipping Window Origin. Upper right 
corner of current clipping window. Ail 
vectors are clipped to this window. 

CREG 11*, 12* 

Diagonal corners for PIXMOV com¬ 
mand source window definition. 








